package cn.youqu.happy.module.youqu.service.systemActivity;

import cn.youqu.happy.framework.common.pojo.PageResult;
import cn.youqu.happy.module.youqu.controller.admin.systemActivity.vo.SystemActivityCreateReqVO;
import cn.youqu.happy.module.youqu.controller.admin.systemActivity.vo.SystemActivityExportReqVO;
import cn.youqu.happy.module.youqu.controller.admin.systemActivity.vo.SystemActivityPageReqVO;
import cn.youqu.happy.module.youqu.controller.admin.systemActivity.vo.SystemActivityUpdateReqVO;
import cn.youqu.happy.module.youqu.dal.dataobject.systemActivity.SystemActivityDO;

import javax.validation.Valid;
import java.util.Collection;
import java.util.List;

/**
 * 系统活动模板 Service 接口
 *
 * @author 王其岩  20112001045
 */
public interface SystemActivityService {

    /**
     * 创建系统活动模板
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Integer createSystemActivity(@Valid SystemActivityCreateReqVO createReqVO);

    /**
     * 更新系统活动模板
     *
     * @param updateReqVO 更新信息
     */
    void updateSystemActivity(@Valid SystemActivityUpdateReqVO updateReqVO);

    /**
     * 删除系统活动模板
     *
     * @param id 编号
     */
    void deleteSystemActivity(Integer id);

    /**
     * 获得系统活动模板
     *
     * @param id 编号
     * @return 系统活动模板
     */
    SystemActivityDO getSystemActivity(Integer id);

    /**
     * 获得系统活动模板列表
     *
     * @param ids 编号
     * @return 系统活动模板列表
     */
    List<SystemActivityDO> getSystemActivityList(Collection<Integer> ids);

    /**
     * 获得系统活动模板分页
     *
     * @param pageReqVO 分页查询
     * @return 系统活动模板分页
     */
    PageResult<SystemActivityDO> getSystemActivityPage(SystemActivityPageReqVO pageReqVO);

    /**
     * 获得系统活动模板列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 系统活动模板列表
     */
    List<SystemActivityDO> getSystemActivityList(SystemActivityExportReqVO exportReqVO);


    /**
     * 校验 系统活动是否存在
     * @param id
     */
    void validateSystemActivityExists(Integer id);
}
